home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / fill402.zip / BRUCE402.DOC next >
Text File  |  1994-02-11  |  29KB  |  577 lines
  1. BRUCE402.DOC
  2. 02/11/94
  3.  
  4. This documentation provides some overview information on a number of utilities
  5. that have been posted by Wayne Software.  All programs described herein were
  6. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  7. Others were written for the U.S. Department of Commerce.  All are free for use
  8. provided relevant documentation is kept with the programs, no changes are made
  9. to the programs or documentation, and they are not bundled with commercial
  10. programs or charged for separately.
  11.  
  12. CHANGE, CONVERT, FILUPDAT, FIXCHARS, and READ are excluded from the commercial
  13. packaging restriction.  These programs are owned by the U.S.  Department of
  14. Commerce and may be re-distributed without restriction.  For these programs, I
  15. may be reached at the e-mail address BGU@CU.NIH.GOV (note--this address may
  16. change in the future).  (BGU@CU.NIH.GOV reaches me for the other programs too
  17. but I'm not to use government resources for Wayne Software things even if
  18. they're free.)
  19.  
  20. People who need to bundle AV, BFIND, COPSINCE, DIRCOMP, DIRTOTAL, FILL, FIXTEXT,
  21. FORTUNE, MULTICOL, NETSORT, READINIT, or READMAKE-created files in commercial
  22. packages other than shareware/freeware collections must pay a $50 registration
  23. fee to "Wayne Software" at the following address.  READMAKE-created files are
  24. also subject to this limitation.  I don't expect to make any money from these
  25. utilities but I don't want others to sell them instead.
  26.  
  27. Comments and suggestions can also be sent to:
  28.  
  29.                 Bruce Guthrie
  30.                 Wayne Software
  31.                 113 Sheffield St.
  32.                 Silver Spring, MD 20910
  33.  
  34.                 fax: (301) 588-8986
  35.  
  36. Foreign users:  Please provide an Internet address in all correspondence.
  37.  
  38.  
  39. The utilities are uploaded with a ZIP name that includes the year and month of
  40. the release.  These names are:
  41.  
  42.          AVymm.ZIP        AV program
  43.                           w/CONFIGWS
  44.          BFINDymm.ZIP     BFIND program
  45.                           w/CONFIGWS
  46.          CHANGymm.ZIP     CHANGE program
  47.                           w/CONFIGWS
  48.          CONVRymm.ZIP     CONVERT program
  49.                           w/CONFIGWS
  50.          COPSymm.ZIP      COPSINCE program
  51.                           w/CONFIGWS
  52.          DIRCOymm.ZIP     DIRCOMP program
  53.          DIRTOymm.ZIP     DIRTOTAL program
  54.                           w/CONFIGWS
  55.          FILLymm.ZIP      FILL program
  56.                           w/CONFIGWS
  57.          FILUPymm.ZIP     FILUPDAT program
  58.          FIXCHymm.ZIP     FIXCHARS program
  59.          FIXTXymm.ZIP     FIXTEXT program
  60.                           w/CONFIGWS
  61.          FORTNymm.ZIP     FORTUNE program
  62.          MULCOymm.ZIP     MULTICOL program
  63.          NETSOymm.ZIP     NETSORT program
  64.          READymm.ZIP      READ program
  65.                           w/CONFIGWS program
  66.                           w/READINIT program
  67.                           w/READMAKE program
  68.  
  69.  
  70. This collection of utilities were compiled using Microsoft's VisualBASIC for DOS
  71. 1.0 compiler.  In each case, Thomas G.  Hanlin III's excellent PBClone routines,
  72. release 2.2, provided additional functionality.  Each of the utilities are
  73. separately described in a like-named *.DOC file.  This documentation
  74. (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves
  75. to summarize what the various utilities consist of.
  76.  
  77. Several of the routines have defaults that can be changed by the program
  78. CONFIGWS.EXE which is included in the appropriate ZIP's.
  79.  
  80. Wayne Software also writes programs, batch files, and sets up menu systems for
  81. people on a for-fee basis.  If you desire this service, contact Wayne Software
  82. at the address specified above.
  83.  
  84.  
  85. --------------------------------------------------------------------------------
  86.  
  87. Summary of programs:
  88.  
  89. A summary of each routine follows.  See the associated *.DOC files for fuller
  90. explanations:
  91.  
  92. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  93. etc) and lets you sort as desired.  Also allows resetting of the file date based
  94. on the archive's contents.  Syntax:
  95.  
  96.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Q ] [ /? ]
  97.  
  98. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  99. one string AND another one, or any line with one string OR another.  The syntax
  100. shown below is incomplete since "search" allows a lot of choices and allows the
  101. use of parens and Boolean operators.  Syntax:
  102.  
  103.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  104.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  105.  
  106. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  107. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  108. commands can be processed in a single pass.  Also provides ability to remove
  109. trailing spaces from text files.  Syntax:
  110.  
  111.     CHANGE infile [ ctlfile | /Cctlfile |
  112.       /FROM string /TO string [ /IN search ] ]
  113.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  114.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  115.       [ /Fflagfile ] [ /Ttempfile ] [ /TRIM | /-TRIM ]
  116.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? | /?&H ]
  117.  
  118. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  119. Is included in the ZIP file with whatever routines it supports.  Syntax:
  120.  
  121.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  122.  
  123. CONVERT.EXE:  Converts data between data formats:  FROM dBase, ASCII-delimited
  124. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  125. ASCII-delimited, dBase, and fixed field.  Syntax:
  126.  
  127.     CONVERT infile [ outfile [ deffile ] ] [ [ /DEF=deffile ] [ /DEF | /-DEF ]
  128.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  129.       [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  130.       [ /TO FIXED | /TO ASCII | /TO WKS | /TO DBF ] [ /HEADER | /-HEADER ]
  131.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  132.       [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /Q ] [ /? | /?&H ]
  133.  
  134. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  135. making sure you have a back-up of stuff and also to copy updated programs to
  136. another place.  Lets you define your own groupings of files if desired.  Syntax:
  137.  
  138.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  139.       [ mm/dd/yy | -n ] [ /ALL | /TEXT | /filetype ] [ /-I ]
  140.       [ /REPLACE | /-REPLACE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  141.  
  142. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  143. delete extra files in the destination subdirectory, copy hidden and system
  144. files, and prepare a report showing inconsistencies.  Syntax:
  145.  
  146.     DIRCOMP directory1 directory2 [ /ALL ] [ /UPDATE ] [ /KILL ]
  147.       [ /CLONE ] [ /ATTR=[H][S][R] ] [ /S ] [ /NET ] [ /Frptfile | /-F ]
  148.       [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] [ /Q ] [ /? ]
  149.  
  150. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  151. some restriction requests (show only files with date greater than a certain
  152. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  153. great program but it doesn't work on network or CD-ROM discs) in some ways but
  154. presents a more formal report.  Also allows you to look for duplicate file names
  155. and search by attributes or dates.  Syntax:
  156.  
  157.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  158.         [ drive: ] ... [drive:]\path[\filespec] ]
  159.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  160.       [ /NL ] [ /-HEADERS ] [ /-FOOTERS ]
  161.       [ /S { GT | GE | LT | LE | EQ | NE } value ]
  162.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ]
  163.       [ /ATTR=attr ] [ /Frptfile ] [ /Z | /-Z ] [ /SUB | /-SUB ]
  164.       [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /Td: ] [ /Q ] [ /? ]
  165.  
  166. FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  167. biggest files first and skipping those that won't fit.  Also provides option of
  168. splitting large files up, labeling output disks, and creating